.TH MSGCACHE 8 "Version 4.3.13:  7 Jan 2014" "Xymon"
.SH NAME
msgcache \- Cache client messages for later pickup by xymonfetch

.SH SYNOPSIS
.B "msgcache [options]"

.SH DESCRIPTION
\fBmsgcache\fR implements a Xymon message cache. It is intended for use
with clients which cannot deliver their data to the Xymon server in
the normal way. Instead of having the client tools connect to the 
Xymon server, msgcache runs locally and the client tools then
deliver their data to the msgcache daemon. The msgcache daemon is
then polled regularly by the
.I xymonfetch(8)
utility, which collects the client messages stored by msgcache
and forwards them to the Xymon server.

\fBNOTE:\fR When using msgcache, the \fBXYMSRV\fR setting for
the clients should be \fBXYMSRV=127.0.0.1\fR instead of pointing
at the real Xymon server.

.SH RESTRICTIONS
Clients delivering their data to msgcache instead of the real
Xymon server will in general not notice this. Specifically,
the client configuration data provided by the Xymon server when
a client delivers its data is forwarded through the xymonfetch / 
msgcache chain, so the normal centralized client configuration
works.

However, other commands which rely on clients communicating
directly with the Xymon server will not work. This includes
the \fBconfig\fR and \fBquery\fR commands which clients may
use to fetch configuration files and query the Xymon server
for a current status.

The \fBdownload\fR command also does not work with msgcache.
This means that the automatic client update facility will
not work for clients communicating via msgcache.

.SH OPTIONS
.IP "--listen=IPADDRESS[:PORT]"
Defines the IP-address and portnumber where msgcache listens for 
incoming connections. By default, msgcache listens for connections
on all network interfaces, port 1984.

.IP "--server=IPADDRESS[,IPADDRESS]"
Restricts which servers are allowed to pick up the cached messages.
By default anyone can contact the msgcache utility and request all
of the cached messages. This option allows only the listed servers
to request the cached messages.

.IP "--max-age=N"
Defines how long cached messages are kept. If the message has not 
been picked up with N seconds after being delivered to msgcache,
it is silently discarded. Default: N=600 seconds (10 minutes).

.IP "--daemon"
Run as a daemon, i.e. msgcache will detach from the terminal and
run as a background task

.IP "--no-daemon"
Run as a foreground task. This option must be used when msgcache
is started by
.I xymonlaunch(8)
which is the normal way of running msgcache.

.IP "--pidfile=FILENAME"
Store the process ID of the msgcache task in FILENAME.

.IP "--logfile=FILENAME"
Log msgcache output to FILENAME.

.IP "--debug"
Enable debugging output.

.SH "SEE ALSO"
xymonfetch(8), xymon(7)

